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This reference memo defines the Alto Ethernet Interface as seen from within the Alto's 
emulator. While we expect that we ourselves will write most of the software which 
deals with this interface, you may find the specifications useful for some special BCPL 
programming of your own. This memo will be revised and extended with experience; we 
welcome suggestions and comments. 

You have received this memo because your name is oh the newly established Ethernet 
distribution list maintained by Adrlcnne Payne. Please remove your name from the list If 
memos like this one are of no interest to you. ^ 

Like other Alto device interfaces, the Ethernet uses several reserved locations in Alto 
memory to receive its commands and to report Its status in cooperation with an emulator 
program. 

These locations are (from "<ETHERNET>ETHERSYMS.BC")i 



manifest [ EPLoc=#600] //Post location 
manifest [_' EBLoc=#601 ] //interrupt bit location 
manifest [ EELoc=#602] //EOT count location, Postad 
manifest [_ ELLoc=#603] //Load location (mask) 
manifest [ EICLoc=#604] //Input count location 
manifest £ EIPLoc=#605[] //input pointer location 
manifest [ EOCLoc=#606] //Output count location 
manifest [ EOPLoc=#6073 //Output pointer location 
manifest [ ESLoc=#610] //Serial Number location 
manifest [I ESpare=#61 23 //Spare 



6EPL0C receives status information (see below) when an Ethernet command (see 
below) completes. GEBLoc niay hold a bit to be set into NWW (new wake-ups waiting) 
when an Ethernet command completes so as to interrupt the Alto's emulator (see memos 
on the Alto interrupt system). GEELoc gets the number of remaining buffer words at 
command completion; It is used for computing the length of an input paclcet — 
PBckBtLonglh-(QEtCLocy-(QEELoc). QELLoc should be zeroed before each output 
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command; it is used by the microcode to hold a mask of ones, shifted In from the right, 
for generating successively larger random numbers in the case of transmission collisions; 
a transmission without collisions leaves SELLoc with a value of 1. GEICLoc and 
6EIPL0C are used to define a buffer for the Input of a packet from the Ethernet; 
SEICLoc holds the number of words and eElPLoc holds the address of the first word. 
Similarly, GEOCLoc and GEOPLoc define an output packet. GESLoc holds the serial 
number of the Alto (see below) and is used by the microcode for filtering out (I.e., 
Ignoring) packets addressed to other Altos. GESpare is a spare location with no use at 
present. 

An emulator program issues commands to the Ethernet Interface using two bits In the 
emulator's SIO Instruction (see our May 10th memo on SIO). These bits are used as 
follows: 



manifest [ EthorOutputCommand=1] //SIO 1 is start output 
manifest [ EtherlnputCommand=23 //SIO 2 is start input 
manifest [ EtherResetCommand=3] //SIO 3 is reset hard/firmwaro 



From within BCPL It Is convenient to access SIO through the procedure StartIO bs 
follows (from "<ETHERNET>AELIB.BC"): 



let StartlO(Command)=(table[ #61004;#1401;] )(Command) 



Recall that SIO takes Its command in ACO and returns the Alto's serial number In ACQ; 
StartIO takes one arguument, I.e., Command, and returns a value, i.e., 
(if 177400)X(SerlalNumber). 

Then, the Ethernet's commands are: 



StartlO(EtherinputCommand) //Start Etiiornet Input 
StartlO(EthiorOutputCommand) //Start Etiiornet Output 
StartlO(EthorRosetCommand) //Reset Etiiornet 



Before issuing an Ethernet command, GEPLoc should be zeroed so the result of that 
command can be noted when GEPLoc goes non-zero. Alternatively, you may choose to 
note GEPLoc with interrupts by setting a bit In GEBLoc. 

The Alto's wired-ln 8-bit serial number (see our memo on Alto serial numbers) should be 
retrieved from the backplane and stashed In GESLoc as follows: 



QESLoc=(#377)&StartiO(0) //Read and store serial number 



If GESLoc Is zero, we say that your Alto Is promiscuous; the Ethernet microcode will 
accept packets regardless of their destination address. A packet addressed to zero, 
please note, is a broadcast packet and will be accepted regardless of GESLoc. 



-2- 



*^lto Ethornot Intcrfoco 



Juno 22, 1074 



Whon the Ethernet finishes processing one of its SIO commands, it posts the results In 
eEPLoc. The Icf t-hnnd byte (bits 00 to 07) of the post code carries the microcode's 
explonatlon of what happened as a result of the command. The right-hand byte (bits 08 
to 15) carries the hardware status at the time of the post. Both bytes of (3EPLcc must 
be Interpreted to tell exactly what happened. Here are the codes to be found In the 
left-hand byte and their mnemonics: 

manifest [ PostlnDone=0] //Input flow terminated, maybe AOK 
manifest [ PostOutDone=1] //Ouput flow terminated, maybe AOK 
manifest [^ PostiBOverftow=2] //Incoming packet overflowed buffer 
manifest [ PostOutLoadOvorfIow=33 //1 6 collisions, load overflow 
manifest [j Po6twordCountZero=43 //User (you) provided zero-length buffor 
manifest £ PostAborted=53 //Flow aborted for some reason (reset?) 
manifest |^ PostNoverHappon=6]] //Serious hardware/firmware bug 



The hardware status bits found in the right-hand byte of GEPLoc (affer a post) are low- 
true; they are normally one. If zero, they signal the following conditions: 



Bit 16 Incomplete transmission, discard Input 

Bit 14 Output command issued causing post 

Bit 1 3 Input command Issued causing post. 

Bits 13&14 Reset command issued 

Bit 1 2 CRC register not zero, discard input 

Bit 1 1 Collision (not used by sof tvyare) 

Bit 10 Input data late, discard input 

Bits 88i9 Should always be 1 ; if zero, failure of hardware 



Routine checlcing of post codes can be speeded with the use of patterns. These 
patterns are formed from the appropriate left-hand microcode byte and normal hardware 
status. 



manifest [ EthorOutputOK-#7773 //Output was successful 
manifest (^ EtherlnputOK=#377] //Input was succossful 



Here is how to reset the Ethernet Interface: 



and EthorReset()=valof 

. C 

(lEPLoc=0 //Clear posting location 

StartlO(EtherResetCommand) //Request hardware/firmware reset 
resultis (QEPLoc ne 0) //Return boolean 



-3- 



Allo Ethornot Intorfaco 



June 22, 1074 



•Tho EthorRosot routine should always return the boolean true; If not, the Ethernet 
firmware/hardware package is malfunctioning or not Installed. 

Timing, and time-outs in particular, are Important in Ethernetting. Here are two useful 
(and trivial) timing routines which support the following Ethernet examples. 

static [ Timer] //Holds number of "tics" to time-out 
and SotTimor (Microseconds) be 

c 

Timer=(IVIicroseconds/70)'M //Convert from Microseconds to tics 

3 

and TimedOut()=valof 

c 

Timer=Tlmer-1 //Count down Timer to wait for time-out 

rosultis (Timer le 0) 

1 



Here is a simple {and not always adequate) way to get en Ethernet packet: 
and GetEther (Buffer,Time)=valof 

c 

GEICLoc=Buffcr!0 //Length 

GEIPLoc=Buf fcr+1 //Pointer to packet's first word 

SetTimor(Time) //Establish how long wait 

GetPost: //Come here to look for new post code 

GEPLoc=0 //To look for non-zero 

StartlO(EthorinputCommand) //Input? 

while ((QEPLoc eq 0)&(not TimedOut())) loop 

if TimcdOut() then resultis false 

if (QEPLoc eq EtherlnputOK) then resultis true 

goto GetPost //keep waiting 

1 
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Here Is a simple (and not always adequate) way to send an Ethernet packet: 

and PutEthor(Buf for,Timo)=valof 

C 

GEOCLoc=Buffcr!0 //Only send what I tell you 

eEOPLoc=Buffor+1 

eEICLoc=0 //No input please 

GEIPLoc=0 

SetTimcr(Timo) //time-out 

GetPost: //Come hero to look for now post 

GELLoc=0 //Start with zero load each time 

(2EPLoc=0 //To look fornon-zoro 

StartlO(EtherOutputCommand) //Go! 

while ((GEPLoc oq 0)&(not TimodOut())) loop 

if TimedOutO then rosultis false 

if (GEPLoc oq EthorOutputOK) then resultis true 

goto GotPost //Keep trying 

] 



If an Input buffer Is specified during on output command, the Ethernet Interface will look 
for Incoming packets during Its retransmission waits (if any); an Input post code Will 
result If a packet comes In under an output; the output will not be done. 

Here is a way to wait for an Ethernet post should one of the above (or any) operation 
failed to post in time: 



and WaitEther(Tlmo)=vaIof 

C 

SotTlmor(Timo) 

whilo ((GEPLoc eq 0)&(not TimedOut())) loop 
resultis GEPLoc 
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Hero Is a good way to send a packet and quickly turn the local Ethernet Interface 
around to receive a quickly returned packet, say an acknowledgement. 

and EthorAround(Count)=(tablo[ 

NEGG+SAO+DAI ; //NEG 0,1 Make count negative 

LOAD+ACO+PREL+20: //LOAD 0.C1 Output Command 

STARTIO; //SIO Start Ethornot Output 

LOAD+ACO+IND+PREL+16; //LOAD O.GEPLoc Get Post location 

iVlOV+SAO+DAO+SZR; //MOV 0,0,SZR Chk for post 

JUMP+PREL+4; //JMP .+4 Posted! 

IIMC+SA1+DA1+SZR: //INC 1,1, SZR Count dopiotod? 

JUMP+PREL+(-42.#377); //JMP .-4 Keep waiting 

DORTN; //JMP 1 .3 Timod-out 

LOAD+AC1+PREL+13; //EthcrlnputOK 

SUB+SA0+DA1+SNR; //Input under output? 

DORTN; //Input under output 

MOV+SA0+DA1 : //MOV 0.1 Move post code to safa placa 

SUB+SAO+DAO; //SUB 0.0 Make a zero 

STORE+ACO+IND+PREL+5; //STORE 0,QEPLoc Zero post loc 

LOAD+ACO+PREL+5; //LOAD 0,C2 Input Command 

STARTIO; //SIO Start Ethor Input 

MOV+SA1 +DAO: //MOV 1 ,0 Return post coda 

DORTN; //JMP 1,3 Rocoivor started 

EPLoc; //Address of Ethernet Post loaction 

EtherinputCommand; //EthorinputCommand 

EtherOutputCommand; //EtherOutputCommand 

EthcrlnputOK; //posted when input comes in under output 

] ) (Count) 



The EthcrAround routine accepts a time-out count for a prespeclfled output (and pre- 
7Grood post location) and returns the output status obtained aiter quickly starting an 
input. 
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